assorted documentation errors
От | Rich Morin |
---|---|
Тема | assorted documentation errors |
Дата | |
Msg-id | p05100383b794c2c0a634@[192.168.168.205] обсуждение исходный текст |
Ответы |
Re: assorted documentation errors
Re: assorted documentation errors |
Список | pgsql-bugs |
Your name : Rich Morin Your email address : rdm@cfcl.com System Configuration --------------------- Architecture (example: Intel Pentium) : Intel Pentium II Operating System (example: Linux 2.0.26 ELF) : FreeBSD 4.2 PostgreSQL version (example: PostgreSQL-7.1.1): PostgreSQL-7.1.2 Compiler used (example: gcc 2.95.2) : gcc 2.95.2 Please enter a FULL description of your problem: ------------------------------------------------ I have been looking over the PostgreSQL manual pages and have noted a number of formatting problems. Unfortunately, as the DocBook source code does not seem to be in the distribution, I have no way of knowing where these problems originated. In any case, here is a summary: createdb.1, createlang.1, createuser.1, dropdb.1, droplang.1, etc. In many places where code and output examples are being given, the font used is proportional. If a monospace font were used, the code would stand out better and the output would line up correctly. droplang.1, dropuser.1, etc. There is insufficient consistentcy to the NAME entries. For instance: droplang - Remove a programming language from a Postgres database dropuser - Drops (removes) a Postgres user Why not settle on either "Removes/Drops" or "Remove/Drop"? pg_restore.1 In the NAME entry, there is a missing space in "created bypg_dump". alter_group.l In the NAME entry, the comma should be a semi-colon: "group; remove". fetch.l In the NAME entry, there should be a comma: "rows, using". Please describe a way to repeat the problem. Please try to provide a concise reproducible example, if at all possible: ---------------------------------------------------------------------- Print the referenced manual pages, using "groff -man" If you know how this problem might be fixed, list the solution below: --------------------------------------------------------------------- Edit the original files and/or fix the conversion script. -- email: rdm@cfcl.com; phone: +1 650-873-7841 http://www.cfcl.com/rdm - home page, resume, etc. http://www.cfcl.com/Meta/md_fb.html - The FreeBSD Browser http://www.ptf.com/tdc - Prime Time Freeware's Darwin Collection
В списке pgsql-bugs по дате отправления: